.TH LFS-QUOTA 1 2020-04-06 "Lustre" "Lustre Utilities"
.SH NAME
lfs-quota \- display quota limits and status for users, groups, or projects.
.SH SYNOPSIS
.B lfs quota \fR[\fB-hqv\fR]
       [\fB-o <\fIobd_uuid\fR>|\fB-I <\fIost_idx\fR>|\fB-i <\fImdt_idx\fR>]
       [\fB-u <\fIuname\fR|\fIuid\fR>|\fB-g <\fIgname\fR|\fIgid\fR>\
|\fB-p <\fIprojid\fR>]
       [\fB--pool\fR <\fIpname\fR>]
       <\fIfilesystem\fR>\fR

.br
.B lfs quota \fR[\fB-hq\fR] \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
.br

.br
.B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> <\fIfilesystem\fR>
.br

.TP
.SH DESCRIPTION
.PP
.B lfs quota <\fIfilesystem\fR>\fR
.TP

Display disk usage and limits for individual users, groups, and projects. \
An asterisk is displayed when the quota is exceeded. \
By default the statistics for the entire filesystem are displayed but \
individual MDTs and OSTs can be specified. \
A user or group name or an ID can \
be specified. If user, group and project are omitted, quotas for \
current uid/gid/projid are shown.
.TP
.B -h
Human readable. This will change the formatting of \
block storage and time values. Without this option block storage values \
are in kilobytes and times are in seconds. With this option block storage \
values use the common metric binary suffixes
.BR k "," M "," G "," T "," P "," E
which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 \
respectively.
Time values use the "XXwXXdXXhXXmXXs" format. This format specifies \
weeks, days, hours, minutes, seconds.
.TP
.B -q
Quiet. Display only the line containing the data. \
The line saying what the data is, and the line with the data
column headers will not be printed.
.TP
.B -v
Verbose. Display per-MDT and per-OST statistics in addition
to the usual system wide data. An asterisk near the OST or MDT means that
the quota is exceeded only for that specific target. The user is over the
quota only if an asterisk is near the whole filesystem usage.
Inactive target will also be printed but marked as "inact".
.TP
.B -u <\fIuname|uid\fR>
Display user quota information for \fIuname\fR or \fIuid\fR.
.TP
.B -g <\fIgname|gid\fR>
Display group quota information for name \fIgname\fR or \fIgid\fR.
.TP
.B -p <\fIprojid\fR>
Display project quota information for \fIprojid\fR.
.TP
.B -o <\fIobd_uuid\fR>
Display quota information for \fIobd_uuid\fR.
.TP
.B -i <\fImdt_idx\fR>
Display project quota information for \fImdt_idx\fR.
.TP
.B -I <\fIost_idx\fR>
Display project quota information for \fIost_idx\fR.
.TP
.B --pool <\fIpname\fR>
Display quota information per OST pool \fIpname\fR.
.TP
.B lfs quota \fR<\fB-U\fR|\fB-G\fR|\fB-P\fR> <\fIfilesystem\fR>
.TP
Display default quota values for users, groups, or projects. \
This command requires super user permissions.
.TP
.B -U <\fIuname|uid\fR>
Display default user quota information for <\fIfilesystem\fR>.
.TP
.B -G <\fIgname|gid\fR>
Display default group quota information for name <\fIfilesystem\fR>.
.TP
.B -P <\fIprojid\fR>
Display default project quota information for <\fIfilesystem\fR>.
.TP
.B lfs quota -t \fR<\fB-u\fR|\fB-g\fR|\fB-p\fR> [\fB--pool\fR <\fIpname\fR>] <\fIfilesystem\fR>
.TP
Display grace times for users, groups, or projects. \
The format is always "XXwXXdXXhXXmXXs".
.TP
.B -u <\fIuname|uid\fR>
Display default user grace times for <\fIfilesystem\fR>.
.TP
.B -g <\fIgname|gid\fR>
Display default group grace times for name <\fIfilesystem\fR>.
.TP
.B -p <\fIprojid\fR>
Display default project grace times for <\fIfilesystem\fR>.
.TP
.B --pool <\fIpname\fR>
Display user, group or project grace times per OST pool \fIpname\fR.
.TP
.SH EXAMPLES
.TP
.B $ lfs quota /mnt/lustre
Display quotas and usage for current user, group, and project
.TP
.B $ lfs quota -u bob /mnt/lustre
Display quotas and usage for user 'bob'
.TP
.B $ lfs quota -U /mnt/lustre
Display default user quotas
.TP
.B $ lfs quota -t -u /mnt/lustre
Display grace times for user quotas on /mnt/lustre
.TP
.B $ lfs quota -u ivan --pool flash_pool /mnt/lustre
Display quotas and usage for user 'ivan' per 'flash_pool"
.TP
.B $ lfs quota -t -g --pool flash_pool /mnt/lustre
Display grace times for group quotas per 'flash_pool"
.TP
.SH SEE ALSO
.BR lfs (1),
.BR lfs-setquota(1)
